brushPattern

Type

property

Summary

Specifies the pattern used to paint with the Brush tool and to fill shapes in an image.

Syntax

set the brushPattern to {<patternNumber> | <imageID>}

Description

Use the brushPattern property to change the pattern used with the bucket, spray can, and brush paint tools, and for the interior of filled shapes.

Pattern images can be color or black-and-white.

Cross-platform note

To be used as a pattern on Mac OS|Mac OS systems, an image must be 128x128 pixels or less, and both its height and width must be a power of 2. To be used on Windows and Unix systems, height and width must be divisible by 8. To be used as a fully cross-platform pattern, both an image's dimensions should be one of 8, 16, 32, 64, or 128.

If the brushPattern has been set since the last time the brushColor was set, the pattern is used instead of the color specified by brushColor. In other words, the last-set property takes priority.

Examples

set the brushPattern to 204

Related

property: brushColor, height, penPattern, pixels, width

command: choose

function: tool, stacks

glossary: property, Windows, paint tool, Mac OS, Unix, current stack

keyword: image, rectangle, roundRect, polygon, spray can, bucket, brush, oval, regular

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile